Summary

• Rewrite docs/README.md as a navigation hub aligned with root README's "The Agent Runtime" positioning and 5-problem framework
• Rewrite docs/getting-started.md as a 5-step walkthrough (Create → Run → Analyze → Lock → Integrate) mapping each step to the structural problems
• Update cross-reference in docs/making-experts/README.md

Key changes

docs/README.md:

• Title: "Expert Stack for Agent-first Development" → "The Agent Runtime"
• Remove "npm/npx for agents" tagline, old "Key Features" / "Why Perstack?" / "Expert Stack" sections
• Add 5-problem table from root README
• Add 3-step "How It Works" with create-expert as entry point
• Add comprehensive documentation nav hub (Learn / Build / Run / Reference) covering all docs sections

docs/getting-started.md:

• Replace perstack start tic-tac-toe entry point with create-expert
• Add Step 3: perstack log for execution analysis
• Add Step 4: perstack install for lockfile reproducibility
• Add Step 5: Production integration (REST API, TypeScript SDK, sandbox providers, runtime embedding)
• Each step annotated with > [!TIP] mapping to the 5 structural problems

Test plan

• All 57 internal links verified to resolve correctly
• Code examples are syntactically valid (TOML, bash, TypeScript)
• create-expert CLI usage matches actual implementation
• API examples based on actual @perstack/api-client source code

🤖 Generated with Claude Code